package com.youcash.ZyWallet_spring.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * @author Zhangzifeng
 * swagger会帮助我们生成接口文件
 * 1：配置生成的文档信息
 * 2：配置生成的规则
 * 3：文档访问：http://ip.port/doc.html
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    /*
     * Docket封装接口文档信息
     */
    @Bean
    public Docket getDocket() {
        ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder();
        apiInfoBuilder
                .title("《真有钱包》后端接口说明")
                .description("此文档详细说明了真有钱包后端的接口规范")
                .version("v 1.0.0")
                .contact(new Contact("张子峰", "www.974957659@qq.com", "974957659@qq.com"));
        ApiInfo apiInfo = apiInfoBuilder.build();
        /*
         * 如何获取一个接口对象
         * new接口，需要在构造器后的{}实现接口中的所有抽象方法
         * new子类/实现类
         * 工厂模式
         */
        Docket docket = new Docket(DocumentationType.SWAGGER_2)//指定文档的风格
                .apiInfo(apiInfo)//指定生成的文档中的封面信息：文档标题、版本、作者
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.youcash.ZyWallet_spring.controller"))
                .paths(PathSelectors.any())
                .build();

        return docket;
    }
}

